
Releasing the power to everyone. 

Reality and Apple's vision 

Tfes^ple II was liitaKiuced in 1977 at the first West Coast Computer rsire. 
The show opened on April 16 in the San R-andsco Civic Auditorium. Ten 
years, four million computers, and a few months later, the same auditorium 
was the site of Septemtier's AppleFest Apple was distributing buttons that 
read 'Ten Years Strong." Finally, after teii yeara no Qt^ 'ftW predtcang l^^ 
imminent death of the Apple II. 

AppleFfests opening Remote speech was given by Del Yocam, Executive 
Vice President and Chief Operating Officer of Apple. Yocam's speech was 
titled "Apple Home Movies" and was dedicated to celebrating the tenth 
birthday of theAjppkll. Yocam's |rcsentatiori included dipsfem old J^f pie 

Tou know^' Yocam said, "the Apple II might have lived and died just 
another gadget if it hadn't been for two drcumstances. First people could 
learn to program on an Apple II using BASIC, a relatively simple programming 
language, without having to load the language into memory. . . J\nd second, 
the floppy disk drive developed by Woz in 1978 assured the Apple II a long life 
....The Disk II and its disk controller card opened the floodgates for Apple II 
sofhA/are, And itwasfesofbraietfaatbioiiptniilliDns ofnwc®tom^^^ 
the Apple 11, 

"the rest of Apple II History is largely a history built on soiftseare:ttatwe 
didn't even develop. That is what 1 think is the most remarkable thing about 
our success.... The success of the early software, like VisiCaJc and ^^ppJe 
Halter, demonstrated to programmers how luaative piogramming could be. 
The floodgates were open. Programmers developed, customers bought 
Apple It's, and the circle went'round,.,. 

"In the eight years I've been at Apple* we've built five generations of Apple 
lis. .. Jn all that time, there was never a doubt on our part that there Syould be 
a next generation Apple II. There are over 4 million Apple lis in the world 
todays But you can still run Apple II software ftom 1977 on a Ilgs, In my mind 
our greatest achievement is to advance the technology and take our 
customers with us. 

"The ^ple 1! exemplifies our dream to bring the power of computers to 
individuals . , . .We've spent the last ten years making the Apple II better, ail the 
while ftillilling our dream of building great truly personal computers. 
, . , Without a doubt the Apple II is advancing. . . .From Apple's point of view 1 
can tell you that in ten years the technology will be to tod^s technology what 
the 11^5 technology is to the Apple IMtoz hyJlt for. the Homebrew Computer 
tiub. Wll advance the Apple 11 in netwrsrhing and cofnmunicatiofis, in 
performance, in new types of peripherals, and in system sottsijarts aod 
programming tools . . . .We are working on multi-media; CD-ROM, and videodisc 
technology." 

At AppleFest I was enthused by Yocam's enthusiasm for the Apple II. I was 
struck by his vision of what the Apple II will become in the next 10 years. Back 
home, however,, teAemvg the text of Yocam's speech, I awoke to Are fact that 
Itocam had cdebrated the p^t.ffltd fiitiiK of the J^Jple II wifiiiaiit oiice 
mentioning AppleWorks, 

^pleWorks was introduced in late ^ril 1984, about three months 
after the Macintosh. The program was originally written fiar the Apple 111 by 
Robert Lissner, an independent developer who had previously done Quick 
file for Apple. 

While AppleWorks was under development Steve Jobs was flying a pirate 
flag over the Macintosh building and outfitting that machine with the famous 
interface developed by Xerox researchers. Over on the Apple II side of the 
street Apple's own researchers were using human subjecls siHing at Apple 
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ke^oards to refine a user interface based on cursor pointing, return key 
selection, and a "desktop" with a "clipboard" for fransiferring data between 
iilgs, lissner incorporated the lesults oflM§i|se3rcliiiitp,Apple>i*jtp^ 

However, according to popular legend, after AppIeWiit «» fetted 
Apple atterjpted to find an independent company to pufillSh tl^ Jif^graifrt. 
Apple itself had two major problems with AppleWorks. 

First Apple was trying very hard to get the big MS-DOS developers to work 
with the Macintosh. One of the reasons these developers gave for their 
reluctance to work on the Mac was their fear that Apple itself wouJd compete 
with them— Apple, obviously, had tremendous advantages in terms of 
distribution and access to inside information. Apple had a reputation for 
developing applications software for its machines that would kill the market 
for similar software— Appfe Wiiter {which was at the top of the Apple II 
software charts at the time) and a complete set of applications software for 
the Lisa being major examples. Powerful voices inside Apple wanted the 
company to get out of the applications software business. 

Secondly, Apple was pouring ail of its energy into promoting the graphics- 
based Xerox interface used on the Madntosh. Among the people \**io were to 
decide how Apple's marketing dollars would be spent there was little hope 
ibr, and less inteieat in, the text-based interfece used by Applelilorks, 

But the legend goes, noJiifLependentconipany with the resources and 
willingness to publish Applelfifcirks could be found. And on a warm spring 
evening, in a joyous moment of v/eakness that followed months of intense 
attention to its new Madntosh and Apple lie liabies, Apple let AppleWorks 
slip out the door, 

Apple's punishment for its indiscretion was immediate— within six weeks 
its illegitimate child sat at the top of the Apple II best-seller lists. AppleWorks 
achieved this without the benefits of a mother's love — it succeeded in spite 
of, not because ot Applell meager rliarketing effiirtsin its:behal£ 

Since AppIeWcfks use released, for example, Apple has run 26 pages of 
ads in A+ magaziftiB. The word "AppleWorks" appears in those ads exactly 
zero times. Four of the ads show screen shots of AppleWorks. T^ke a look at 
Apple's Ilgs ad in the September 1987 M if you have one handy (pages 35- 
59). AppleWorks appears in the gutter between the pages and is the only one 
of the 25 programs shown that isn't mentioned by name. This is typical of the 
treatment Apple's liastard child gets from itsmother. Yocam didn'tmention it 
or lissner in his birthday speech, and John Sailley, Apple's president 
doesn't mention it or lissner in his new booii, Odyssejj. 
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3.74 Open-Apple 

Before the en d of 1984, the year of the Macintosh, a software product for an 
Apple computer had dislodged the almighty Lotus 1-2-3 fmm the numtier 1 
position in monthly retail software sales. One would expect no end to the 
baUyjioQ, But the Lotus-killer was AppleWorli^, mi cojpoiate Apple 
celebrated tnumph with sileiKe, 

lyurinSldSS, 1386, and 1987, oorporatei^plf^'sieacf an toits iUegltin^ 
dnld has been to coiriiTme to pretend that It doesn't exist AppleiHbrks, In 
him, acts lilte a child of Satan as fer as j^ple is concerned. Dot only does the 
piogram's success heap scorn on the Xerox interface, AppleWorks eats third- 
party software alfve. In Cupertino, the fact that since mid-1984 Apple Itself 
has earned a large proportion of the profits available in the Apple II s<^t«/are 
market has been a matter of concern rather than a matter of gloijc 

It's tune for Apple to sie^ pretending, to modify its idsioii, and to 
admit to the rea% ot WM Appie II Ins teawie tStOitx the 
NacJntosta was Introduced. In the ttnee years since January 1984 mtm 
than 2 million Apple lis have been pioduced and sold — well ov^ half of all 
Apple tls in existence. Just as VisiCalc made the Apple ll-Flus, just as lotus 1- 
2-3 made the IBM-PC, just as desktop publishing has made the Madntosh, 
AppleWorks made the lie and lie 

Realily is that AppleWorks has tiecome the essential characteristic, the 
ddining characteristic, of ttie Apple 11 ^mily. They laughed when AppleW3rks 
sat down to play int^ated soAwate on an &-bIt computer, but nowhere ims 
toitegiM sdbiiaie met near the suixess Het it hds nil the Apple % 
AppleViork'i speed, ease of use, and seaml)^ intepeeSon hive set 
standards for all Apple fls of the future. 

Realit)' is that more humans have learned the AppiieWbiks interface during 
the last three and half years than have learned the Xerox interface— even 
though the Macintosh had a three-month head start Apple's insistence that 
the )ferox interfiace is the only interface in Apple's luture is as stupid as saying 
that the only legitimate music is rock and roll or that the only legitimate 
library fonn is the romanHc novel, Qeneral Motors got to the straits rt is in 
Isdagr removing the dlstlnctlofialie^Meen Its automotbe SmiiSBS, not by 
lett^ a Gheiai^ b^a QienQlet EUdaFdnliE^^ Mffi^ 

Reality is !hai^ M producitrtiy area (word ]»t)cessdrs, data bases, 
spreadsheets, and similar programs) of the Apple II software market is a 
shambles. Apple has notonly taken all the profit out of this market for three 
and a half years — it has put nothing badt ifl. Pretending and wishing ttiat it 
wasn't happening, which has been Apple's ptimary reaction to date, has us 
on the edge of a disaster. (A secondary reaction has been spinning of a 
Madntosb softti^ comj^iry andattempting to sweep AppleWorks under Its 
stdits.) Only orte estab^bed vended cf pTOdix:dvity softt^/lfefcf Perfect 
attended ApplePest Wxit will future Apple II productrvily software come 
&om? At a dinner ibr developers the night before ApplcFcst Sculley said tfiat 
the APF^e ! I software market is the only one left In \M± small, independent 
desKlopers aren't totally dominated by larger companies. That's true and, in 
general, that's good. But if Apple couldn't find a company strong enough to 
publish AppleWDrks in 1984, before it spent three years soaking up all tte 
pipflts in this market, how could there be one lipw? pulley thinks there are 
companies in the A{f>le 11 market with th^ resotntoes to dev«^ a prDduct 
su<h as f|(peftap4 \iiWtte6^ 

years to develop for the Macintosh. But Scully said he's lo^i^ to 
Independent developers to provide Siat product Ibr the Apple II, CSven the 
amount of money earned byApple II dei^p^ during the last ttnee yeaiB, 

the idea is ludicrous. 

Realily is that homes are the final large market for personal computers. As 
the numtrer of computers In schools and businesses mounts, we are 
approaching a threshold across vHuch millions of people will decide to 
purchase computers for their homes. The Apple ll's dominance in «Jido1s 
wnt piit pressure on parents to bi^i^les. ^owesiier^ Qit i^tm^ 
DOS in businesses will put pressure on parents to buyctoncs. Appleis giving 
a large share of the home market away to the clones by not marketing the 
Apple 11 as a machine capable of giving both kids md adults the, power to be 
tfieir best at home. Tor example, on October 12 Apple sponsored a network 
television celebration of the bicentennial of the li.S. Constitution. Of the 
twelve commercials shown, eight had to do with the Apple llgs and kids or 
educatlon,twD vdth Apple itself, and one with Apple lis and the disabled. The 
sixth conrmerdalshown was titled "The Home Ofliij(%''ltalonepipn)Pt^ the; 
idea (^computer use adults and it alone promol^ the Hacs^^ 
as a whole, Apple's message was that the Apple U Isn't suitable for use at 
home by adults. This isn't a message that will maximize Apple's share of the 
home market nor is it a message that reflects the reality of hundreds of 
thousands of Apple lis in homes right now giving adults the power to be their 
best 

Apple wUI never acknowledge the existenceofits illegitimate child or begin 
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to show that chiid love without first bringing Its corporate vision in line wflfh 
reality. What Apple must incorporate into its vision is wiiat Apple II l^eas 
realized months ago— Siat AppleWorks has shifted the distinction betwsisi 
"^tems softw^" and "applications softwEDS." AppleWorks is the ^sterns 
sojiioare that Apple H users want buntlnto tisfr machines — AppleHfarks fe 
fte "j;?ia$}nn" &iat£q)p3cations developers want to build bom. 

Afire are the ideas I wotild champion if! worked for Apple. 

First, corporate Apple should acknowledge Robert Lissner's contribution 
to the Apple 11. He should be an Apple Fefioni like Bill Atkinson, developer of 
WacPaintand Hypercarti; and Alan Piay, developer ofthe-Xerox icons. 

Second, corporate Apple should acknowAedgewhat Apple II users aheac^ 
realize, that the "operating system" of the Apple 11 ends on the AppleVtorks 
desktop. AppleHtoiks should be in the box with cun^ent Apple Us and should 
be hUttlnio ffie lOI of hiiyAliliileM pl^ ofRnmased hodcs for 
Independent developers to get their teetti into). 

For example, a developer of application languages should be able to allow 
users to write programs with the AppleWorks word processor. When the user 
is ready to run the program, open-apple-K could compile and execute the 
program. The program should be able to take control of the saeen, to 
request AppleWorks desktop memory, to access files on the desktop and on 
di^ to use aH otho: operatings^tem tods, and so on. 

For wm^a devdojpfior cxunmunications scAwaie shQuld be able to 
add a cM^M^orts ^pai!% to the Ij^Hdss wo^ fooamoi. A 
dmlc^ of graphics soffavare should be ahlie lb write a program that is 
adivated whenever a graphics file is added to the AppleWorks desktop, A 
dflfeloper of spelling checkers should be able to write a program that works 
inside AppleWorks. And these developers should be able to do these things 
without worrying that Apple will add those features to a fubae v^cn of 
AppleWorks and cut their market out &om under them. 

(For additional information on Vi*iat "applications software" is if Api^eWadts 
itself is "^tem software," take a took at the programs in Beagle Bros' new 
time Out Series. Conbiaiy to tiie popular esqpectatron Qiat Ugs products 
wM dicaninate: ^pleFest most iit the people 1 talked to said they 
oonsSderedilite ltme Out Series to be the bighit of the show) 

Apple is reportedly investing a large part of Its research and development 
funds in system software technology. A fair portion of that money shcHiId go 
into a system Software platform" based on AppleWorks that defines an 
Apple II, rather than one that defines a Macintosh. 

Third, corporate Apple should acknowledge the havoc its illegitimate 
child has caused in the Apple 11 softwarE; martet Apple should reirwest the 
doUaarsithss mafefrohi Applelilbrksin a'TIarshaH Plan"for Apple 11 software 
developers. Ihepbn should be dfaected at small one-andtuio-programmer 
cbmpanies tfiat are committed to the concept of Apple 11 Forever, latlwr than 
at large companies that are primarily Macintosh and MS-DOS developers. 
The pian must be designed as an tjiuestment in the future of the Apple U 
rather than as a profit center. 

The plan should include strengthening Apple II Developer Tfedinical 
Support to the point that it can provide haining by correspondence (ratho" 
than by a trip to CaJIfomia that is too expensive in both doUats and time). 
Developer support ^iild also pros^dedechnrUtfei^nslbr the iV^^ 
and implonerttation Of sofiMaie ^ndards, an inteifece between software 
devebpm and Apple's own hardware and systems strftware engineers, and a 
continuation of its current technical iKip by electronic mail. 

In addition to technical help, Apple II developers need marketing help. 
Presently this kind of help goes only to Apple II developers who share Apple's 
vision of the Apple 11 as a toy Madntosh. This help has to be extended to all 
Apple 11 dwelopers, no matter what thdr visioa In the Apple II kingdom, it 
hasalwa^tieen developeisandaistomers wtehave^In the end, detemiined 
Qieittsction of tlte U, Apple's hdp ahcuiabe asiOiible to all. 

^iicelil8i,i^le'avbi(mortliei^iple If aiulfiiet<ea]ity of the An>le 
II have been getting farther add fiuther apart. time for Apple to bknv 
away the Macintosh smoke and look at what the Apple 11 has actually become. 
The realify is a machine defined by AppleWorks, The good part of that reality 
is that the Apple II has developed its own identify, distinct firom Macintosh 
and MS-DOS machines. The fiiture of the Apple II will be unlimited if 
corporate Apple builds on reality by making AppleWarks part of the Apple 11 
'iS^stein. sortie pl^jjbim" and niarHets the power of that leaiij^ to 
sMis vlih the eotmista^ g has Iteii^foie gen^ated only # 
Macintosh. The bad part of that reality is that Yocam's observations about 
why the Apple II was a success are no longer true. Few software companies 
besides Apple itself have profited firom Apple II development in the last three 
years. If Apple is serious about producing advanced Apple lis ten years from 
now, it should invest its AppleHforks profits now in tebuflding the Apple n 
software industiy. 



nowanberlSST 

Control-I(ntei1ace) S(iandards), continued 

"Rimnng . . . rinnng . . . Hey you, get up there. This is Oscar the Grouch and 
I'm telling you it's time to get up. And don't forget to wind the clock so I can 
wake you up again tomonrow. . . .I^innnng . . . Rinnng . . , Hey you .. .." 

Early feedback on last month's lead article indicate it was a sleeper, 
especially for those of you among our readers who don't write programs. I 
hop«pii'll luide^igand that I occasionally have to resort to articles like that 

mafe^inff leESs e^er in the Matb Based on the mail we gel; malfing a 
printer do v^tte salesman said It vaul/l siJH seems to be one of tfie 
primary profiifems fai the Apple kingdom. Most oFthese probiems ale nxJted 
in a lack of standards for printers and printer interface cards. 

(^KifApple'a readers extend from those of you who don't program, up 
thorough novice and intermediate programmers, up through commercial 
hardware and software developers, and right into ttie labs where Apple's 
engineers are designing fiihjre Apple lis. We aifi aILultiniat£ty, Apple Uusers. 
Things wHl go smoother for all (rf us ifihe piDgranuners;, $ieii«lbpas, and 
engineers amorig lis mi apse on» imdectiand and iUlow a fev moie 
standards than we have in the past €patApfle is in no positi(Si to 
promulgate Apple II standards, but I do want to piDvide a forum for raising 
issues, for uncorering problems, and for providing pressure for better /^ple 
II standards. Thafs part of what you're paying for when you subscribe to 
Open-/4pp(e{and a little nap now and then is healthy, they say). 

At any rate, this month's quest should be more interesting to most of you. 
Instead of looking at interface cards ftpm the piDgtammefs point of view, 
we're gdng to Ic^ at them torn the user's pdnt of view Wvn gdi^ to 
iBvesti£^ to deM 1}k! user tX)fMsMWi ^Mttral XpfMs Huee most 
popular serial inteifece "cards" or "ports.'*There are significant dlieiences in 
what these commands do and how they work. Detailing these diffiEiences 
here in Open-Apple should help users get the most out of their interface 
cards, should help programmeisand developers understand how to getthdr 
programs to work on any Apple n Iwm yaaSt}, and sh^d help ^iple's 
engineers to stay consistent 

The three int^faces we'll be examinii^ are the Super Serial Card, which is 
iBedin Il-Pluses andlles. and fte serial ports on the Apple Itc and llgs. Hie 
ftniwaie for the Super Ser^ Card was wttten by Apple's Lany Kenyon. Die 
He serial firmware was written primarily by Apple's Rich Williams, And Jhellgs 
serial firmware was written primarily by j^ple's MikeAskins. 

Consistency with the Super Serial Card was not the highest priority in the 
design of the He or llgs serial firmware. Particularly with the original Apple lie, 
the limited amount of space for firmware was supposed to make emulation 
impossible (the lie had to fit firmware for two serial ports and the mouse in 
same amount of address space the Super Serial Card used). Though be was 
supposed to desigD just a simple serial intei^e, WUUaniB managed to 
squeeze much of tlte fundiona% of the Super Serial Catrd thtb the original 
lie He did such a good job that today peoplewonderwhythe down v,ho wote 
the lie serial firmware didn't emulate the Super Serial Card ex^tly, rather 
than wondering how the hero who wrote the lie ser^ flnSHSore managed to 
squeeze all that stuff into such a small space. 

nodes and defaults. All ttiree serial interfaces can operate in either a 
"printer mode" or a "communications mode " Printer mode is used for one- 
way transmission, as from jKXff computer to a j^^|;:^^n3|U]nJS^^ 
iDodeisusedlor twc!^t[an«EM)ii.,as£KHnyiwi;^^ 
emdhadi. 

Thenipdelhat an interface operates in hasiDbe s^iq):Bhead of time — it 
canlKitfie changed with a command. With the £iuper Serial Card, you specif 
Ihe mode by setting a dip^switch on the card Itsdt The manual tells you how. 
IBth the 11c you specifythe mode using the lie System Utilities program. With 
the llgs, you specify the mode using the control panel 

The lie and ligs default to printer mode on port 1 and communications 
mode on port 2, This is what you'll always get when you turn on the lie. The 
llgs, on the other hand, sti^ l^ control pand settir^inbatteiy BAM, so I^ 
you change these debtilt modes it wiH t&mtiber yotii^ new tabice iidifle 
turned off. Ifyou change the lie power-on defeults wifli the St^stem Utilities 
program, whatactually happens is that some values in the"au}dllaiy memory 
screen holes" are modified, The new values will be remembered as long as 
the He is turned on. Every time you initialize a lie serial port the firmware 
looks in these saeen holes to see what the current "dip«witch settings" are. 
You can modify these values with your own programs— for more information, 
see our riovember 1985 issue, pages 186 and 187, 

hi addition to mode, all Ihtee intei^m support a number of other 
variable tl^ffacteristks. Each devloe flsunes out fne default characteristics 
you want the same wsiy it figures out Its mode— dlp^ttdi setting for the 
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Super Serial Card, auxmem screen hole values for the lie, and control panel 
settii^ for the llgs. Some of these variablechaiacterislics include baudrate, 
datttibnBat:pa%edio. feusdOi, and imiSSoQt^Gsi^iBgsveltv^ 

In most ^toatibns, your goal as a user should tie to setttiese debiitts^ 
values that support your equipment and leave them alone. Ifyou succeed at 
this, you don't need to know anything more about serial interfaces. 

Cammand syntax. The rest of us will now lean about how to send 
commands Biat cause an inteifece to change its chara^sdstica fiom Iheir 
de^t values tosomethlngelse. 

The Super Serial Card and tiie seiial ports on the lie and Hgs can all I)e 
contndled by embedding "command strings" in your printed output The 
idea is that tiie serial firmware m\\ recognize and intercept these stings of 
ASCII characters, then act on them rather than passing them on to the 
printer or modem, This is a common method for controlling devices 
attached to a computer —your printer and modem probably have their own 
command shings that they react to. Even the Apple's disk operating system, 
when used fiom i^iplesoft, Is controlled bfyGonunandsbin^ Both the Basic 
Inta&oe and the Advanced Intei&icB (dae littdMh as It'-^iese last 
BKHiBt's artlde lor moie information} on^pple% senallnnMpe lespond is 
command sbing3> 

Though common, the technique isn't foolpitM Xontrol-Dlefeated)" in 
our December 1986 Issue, page 2.85^6, (Hscusses a number of specific 
problems with the embedded command shing technique. On the other 
hand, the technique is quite flexible and allows for a great deal of 
compatibility. Aj^l^llforks, for example, pren/ides a way for you to alter an 
interface cati oommand sbii;g that will be sent each time you print 
scnnethin^ Sbice you ate ablie completely conbd the cwtents <k the 
command shing, you can adapt^pleWDiks to any intefface card that reacts 
to them. The alternative methods of controlling devices, such as POKEing 
controlling values into memory or CALlii^ command routines, prowde finer 
control but less ease of use and less compatibility. The llgs serial linnware, 
incidentally, does support control caDs as well as command shings, as 
discussed here last montti, but the Super Serial Card and the He allow only 
command shings. 

Apple has used three dp^t fonnats for serial interface cp|nII^nd 
strings. All begin with a command eftarader (usually conbol-f or controlWIi, 
mote about this later). In the first format, the command character is followed 
by a single, non-control character, for example "contol-I R. ' In the second 
format, the command character is followed by a decimal number, which is 
immediately followed (no space character allowed) by a single, non-control 
character, for example "control-1 80ri," In the third format, the command 
character is foltowed by single, non-control characto', a space, and either "E" 
(enable) or "D" (disable], for example, "control-1 L E" (the 11c technical 
reference manual says Iheie should be "no inteivoiing space" widi this 
synta^C htMwer, Bie 11c actually ignore spaces; the Super Serial Card 
requires them). 

The Super Serial Card, the lie, and the llgs each has its own spedal rules 
about vrtiether extra characters, spaces, or lower-case are allowed within a 
command string. To keep your software as compatible as possible, always 
use upper-case characters and never include spaces or extra characters in a 
command string, except for the space that is required Immediately before 
"E" oar "D." (If you are writing fvrmime, on Uie other hand, you'll get Ihe 
gteedsst compatibility by allowing Ihe lower-case versions of conunand 
dtanacters as well as upper and tiy making spaces optional anywhete \a flie 
command shing.) Apple's firmware will accept commands wiiether they are 
sent in high-value ASCH or low-value ASCI I, if you are writing firmware, make 
sure yours does as well. 

An important difference between the Super Serial Card and the lie and llgs 
serial firmware is that the Super Serial Card reguiresa Return at the end of a 
command string. The Super Serial Card con^deis everything between the 
command character and the Return dieter to he part of flie OMnmand 
shing. none of this. iRdtnflns ^ Bietmi Usdf, is sent to the printer or 
modem. Bven if the command is unrecognized, fbe Super Serial Ceud wflj eat 
it all. On ttie Uc and llgs, on Ihe other hand, at least some portion of an 
unrecognized ccnrunand is usually passed on to the printer or modem. 

In addition, the He, llgs, and most other Apple 11 interfaces do not require a 
Return at the end of the command string (the Super Serial Card is the non- 
standard device). If a Return is included, it is always passed on to the prints: 
Thus, any program that uses interface card commands and thatis interested 
in controlling the position of the paper in the printer must figure out if it is 
using a Super Serial Gardornot lif so, it should put a Return at the end of all 
Gommands (tijto^— except three "paraUd canT command^ and Ihe 
"donge conimandrcharactra comnrand," all noted later). If fh£ pn^tam Is 



3.76 Opeft'j^ple 



running on a lie orllgS; on the other hand. Returns at the end of commands 
JsbQuh) abi^ t^sif>pP^e4(wtioops— e»£ptafl£r a special version of the 

Fbr example, ifyou are setting up an interface card command string within 
^pleltorks, you have to know whether the command requires a Return or 
not If it does and you leave the Return off, the command will either not be 
executed or will cause other piobtems. If it doesn't and you put one Okie 
anyhow, your will lie advanced one fbsa wtthont^pIeWbrle knoi^ 
about It 

Another problem is that since the lie and Ilgs don't require a Return, they 
aUouf i^ininand stiings to be strai^tcgetlier, such ^ "contid-1 80M controt- 
I L B'' 11^ domt iSfOik vritt) ftfi Super Serial Card because the teq^ied 

Return at the end of each command is missing. 

The commaBd character. As mentioned, each command string must 
begin with a "command character." The command character defeults to 
ccntiDl-I in printer mode and control-A in communications mode with all 
ttnee of ^ple's devices. You. cannot specify a different tiefauM command 
character. However, all three devices allow you to change the command 
character after initialization by printing the cunEnt character and following it 
with any other control character except a carriage return . "Control~I control- 
Z" (CHR$(9);CHR$(26)) for example, will change the printer mode command 
character to contml-Z. "Contnol-I Return" |CfiR${9);CHR$(13}) does notWng. 
•"ContiDl-[ control-Z Return" {CHR$(9),-CflRS(26),<:HR$(13)) changes the 
command character to conhwl-Z and passes a Return to the printer— even 
Mdlh theSuperSerlal Card. OnthfiUc"contiDl4 control^' (CflR$(9)^ 
testfictHidOdiKriehted feabte 

command, about whi± we'll talk more later, So don't use controls. Another 
character that causes problems is control-D. It interferes with DOS. V^ous 
Apple manuals also lEcommend against oontiQtA.'f, •<* -H, -L-J, 4,f-Hand 
-Y Control-Z is frequen tly used. 

The firmware in the lie and in the Ilgs resets the command character to its 
default value every time the firmware is initialiied. This means that after 
every PR* (in*) or ITflT caU (the IMIT call is available under the Advanced 
Interface) the Uq/Ugs corranand (Jipacter is reset to control-I or controfcA. 
The Super Serial 6int on flie otihGr tiand, dises mt reset the Gommand 
charKter to the defeultvalue. With the Super Serial Card *m printer mode, do 
a FR#1, change the command character to control-Z, and do another FR*1— 
the command character will still be control-Z. On the He and Ilgs, your 
second PR*1 will reinitialize the command chaiacto' to contaoM, hi this 
respect the [Ic and Ilgs are IM most other Apple U Imter^ catds^the 
SifierSerialCard is the non-standard device. 

10##feBaiE6#af fie root of a fair proportion of "priflta^tsw^^liftS and 
JsfltilpdiAant to understand It applies not only to the command chaiKlet^ 
M to aflSuper Serial Card default characteristics except "Zap" status. Ate 
a PR*1 or the equivalent the Super Serial Card will reset itself to its dtp- 
sWltch defaults only if this is the first initialization follovrfng povrer-up, 
fciHowing control-reset orfollovnngthe Super Serial Card's R(eset) command, 
Inall other cases, FR*1 leaves the Super Serial Card's characteristics as they 
WB^ when the flrmwaie was last used 

Gom&^im^^ any piDgram that uses the Super Serial Card and that 
cliing^ iie d^iult setfings mnst also uncftanf e Hmu S ft do^t; 
subsequent pn^rams, or even Hie same program run a second time, rns^ 
find the Super Serial Card unresponsive to commands. For example. If a 
program changes the command character to control-Z and negects to 
change it back to control-I, control-I comma nds from programs run later will 
not be recognized by the Super Serial Card. 

If the same program is run a second time, for instance, it will send the 
control-I control-Zcodeagain, The control-I will be sent to the printer and the 
contn3l-ZwiUbeiecogniz£d3pti}eb^nRll1gofa<x)nimandP^^ 
thing sentisacommandtoaiMllsefeiAtet^^ hW 
When the Super Serial Card sees the two contn^Zs in a low it udll send the 
second one to the printer. Thus, the contiol-I, thesecondcoirtrol-Z, and the"L 
E " will be received by the printer— not the pvogram's intention at all. 

Hone of this is a problem with the lie or Ilgs, but to make your program 
compatible with the Super Serial Card and tli&d parfy cards that emulate it 
you must always change the command character back to control-I if you 
tjiange it to anything else. Mal« sum that diai^ baefe eseaff^jur 
veer i^fcips printing in mid-page 

%ssa user, you iinda commercial program in your lQ»aiy that^aeani't 
etitBn Qie Super Serial to itB defaultjM^tiiig^, 1heo#ftii9igtl !Can do 
to set ttiings right is to ton iie eoo^tder off or peis canttel-iieset after 
ninnitiglhe piDg:ain. "nieFefsa dra^ 



"control-I R" reset command (more later) but if the command ch^ractss'tras 
been changed, cveiilhlacQiniBand wiUg^ 

Tbe^tmeiitfi^ti^ tivo eoittinatid in aiowsends one of dieni 

to the printerworks only on the Super SeiMCea(d,NdtherthenQiiQrttae Ilgs 
support this, so don't use it 

Wilt you might expect that all third-party cards vrould use control-I and 
control-A as the defeult command characters, it isn't so. The popular 
QrapplepPlus uses control-Y for commands sent to its Advanced Interface 
(see "Qo, Logo, Go," September 1987, p%e 5.64 fbr a good example of the 
kind of problems this catises). ffirtnw^ 
landcQntrol-A. 

KCsef. AD ffieee tatei^ees vuS^ dtossion here support the "reset 
firmv/ate" command This command tells Qn^ Snowaie to reset itseilf to its 
"dip-switch " (auxmem, control-panel) defaults the hfext thnte It is initialized 
However, on the 11c and Ilgs this always liappens automatically, whether 
you've used the R command or not The R command also disconnects the 
interface firmware. With a Super Serial Card, tills wil! jol t your screen out of 
80-column mode if its in it Thus, Reset Is an ill-behaved commarid that has 
no useful effect ^cept with the Super Serial Card nonetheless, any program 
that uses odi^ command strings should issue Oils command as part of its 
Qurr iDufiiie, SO Bteit Bk nert pnagrarti iifet runs can assnme a "normaT' 
serial interface. The syntax is, for example, "oontnAA K"To avoid the 80- 
column jolt try a program-ending sequoioe Use this one 

9990 RCn . , .enij of prsgrtn 

9991 HOME . : HEM clsar screen to auoid Jolt on sultch 
9993 PRINT CHflli(?l.) : REM turn off M columns JuSt to ba SSfa 

999S PRINT CHH»(1);"PRt)l" : REfl torn on serial port 

999G PRINT CHfiI[9);'R' : REM reset dBFaults and turn serttl part aff 

9999 PRINT CHRS(4) ; 'BVE' : m back to the program selEctor 

Zap. The Zap command was designed to solve some of the problems that 
occur with devices that use embedded command strings. After you fesue a 
Zap command, the interfiace firmware will stop interceptii^ command 
strings and will pass everything it receives on to the printer or modem. The 
Zap cj^tpmandii^ hand)', for example, when you »Qirt.to siend stdggs of buiaQr 
data to a pt^iterfer a graphics printout or for a dowtfloaded diatacter 
Without Zap, problems occur ifyourbinaty data accidentally indudesavalue 
that duplicates the interface firmware command code. That byte and an 
indeterminate number of the Mowing bytes will get swallowed by the 
firmware and your picture or character set wfll have a hole in it The syntax fbr 
Zap is, for example "conhol-l Z," 

To turn Zap cB, simply do another fM (II1#) command or make the 
Advanced rbrnware RITr call. Titts wi»^«»|h^i^ Sif[gF#£4i:©itd. 
Ihens Is no command string for tuning Zap oC obviou^ because the 
firmware is ignoring all command strings vAien Zap is on. 

Because the Zap command is typically used before sending binaiy data, 
many programmers make the assumption that in addition to telling the 
finnware not to eat any characters, it also tells the firmware not to burp ai^ 
additional characters into the character stream. This is not the case. 

Apple's serial lirmwaie can be set up to automatically burp both linefeeds 
and carriage returns into a character stieanu Linefeeds, if burped, are 
buiped after Returns. Retum$> if fiixqied, &ss hUrp^l when a spedBed 
tmmber of characters have pa^ed without a Rduni. This Iw lin^ 
control. With the Super Serial Card, the Zap command has no ^ct on dther 
linefeed or Rehim Insertion, ffith the lie and Ilgs firmware, the Zap command 
automatically turns off Return insertion, but has no effect on linefeed 
insertion. 

Thus, if you are using the Zap command to pass binaiy data to a printer or 
modean and you don't want occasional extra bytes inserted into your data, 
you ^uld turn off both Return and linefeed insertion beEore executing the 
Zap command. If you do this with a Super Serial GEHfd, don't ibrgel to have 
jPourpiogEam tmtbepiioterhffiic on and Issue ttie R^ain^ 
IteQUlTroueite. 

Linefeeds. A "linefeed" is a control character that tells a printer to 
advance the paper one line. Many printers require a linefeed after each 
carriage return, si nee all they do in response to the Return Is move to the left 
edge of the paper. All three of Apple's serial interfaces have the ability to 
cither add or not add a linefeed after eadi caniage return you send. 

In genetal the default setting for linefeedinsertionisOriwith printer mode 
and OFPwith c(»{miunication& mode. Howewr, QieSuperSenal Card allows 
you to conbol this delaiilt \JISb. a di^^tdi in printer mode, and the 11c and 
Ilgs, using the He's auxmem saeen hole values and the IIg3'scontroli>and, 
allow default coritroi la bolfa printer and communications modes. 
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If the default setting isn't what you want or if you aren't sure of the default 
you can force linefeed insertion to OFF witti the K command. This is one of 
the three "parallel" commands that don't require a Return on the Super 
Serial Card. (If you put a Return after this command it will be passed to the 
printen) Qn the Super Serial Card this coimnan4 all parallel card 
(smiSBan^ works only in printer mode. Oh the Tk mA 1^ It ifflsifts in 
conoMiUtodoiis mode, too. See "One of the first interlace cards designed 
far ttie Apple n" in last month's issue, page 3,65, for more inftjrmation on the 
heritage of this and the other parallel card commands. 

Unfortunately, there is no univensal way to turn linefeeds Oft with Appie's 
firmware. The Super Serial Card, the 3.5 ROM lie, and the llgs support an 
enableydisable linefeed command that goes, for example, "controH L E" 
(command-code. Linefeed, Enable) or "control-I L D" (command-axte, 
Unefeed, Disable). Tte oiipialllQdoesn't support this ^ts. The original 
11c firmware does support an L comiRand, however, tiiat will turn linseed 
insertion on. It goes, for example, "control-A L." The 3:5 ROM 11c firmware sort 
of supports the origina] lie's L command, but not very well (the 3.5 version 
seems to require either another command character or a Return after the 
"L;" if itgets aReturn it eats italthough the oriiginal ncfiimwrne would pass it 
ttiiDu^}.M)faerfhe Supo'SoMCardiwrfbellgssnpixntihe 'Inversion at 
aH 

In addition to inserting linefeeds into the data it sends out all Apple serial 
Emmit can also delete linefeeds fiom data, coming in fiom outside the 
computer. Obviously, this has no meaning in printer mode, so it applies only 
to communications mode. The default setting for this feature is amish-mash. 
The Basic Interface on the Super Serial Card and bo&i versions of the lie 
firmware default to deleting incoming linefeeds. The Advanced Interface on 
the Super Serial Card and both interfaces on the llgs firmware default to 
allowing incoming linefeeds to pass through unmolested. 

IMth the Super Serial Card, the 3.5 ROM lie, and the llgs, you can use a 
HbsK linefeeds" command to contiol linefeed deletion. For &mt^ 
'i^XiSl^hWE' (cprtntmdix^ I^le) causes incoming linefeeds to 
fee ^MeM; '^conftol-A M b" (command-code. Mask, Disable) causes 
intionjihg linefeeds to tie passed With the original lie, there ^ iK) Vffly to 
ctKUige Ihe default— Incoming linefeedsaie always deleted. 

Screen ecbo, ttne wtclfli, and netnm. "Socen edto" has to do wiUi 

whether the data you send out from your computer appears on your screen 
as you send it in the context of serial ports, this characteristic is also 
sometimes called "video." Some commands for turning saeen echo on and 
off also affect "line width." Line width affects how often Returns are burped 
into the character sheam being output However, on some liitertees, IMe 
width isn't the raily variable that controls Return insertion. 

First lets look at Return ins^on. The Super Senal Card, the Uc in 
communications mode, and the llgs all de^ultto HOT eddii^ Returns when 
the specified linewidth has been reached. Thettlginal He firmwaie in printer 
mode (and most parallel card firmware), on the other hand, does insert a 
Return vAiw the specified line width has been reached. This can be a 
problem when using condensed characters with software such as AppleWorks. 
At 17 characters-per-inch you can get 136 characters on an 8 inch piece of 
paper If the interface firmware adds a Return after every 80 characters, 
howevor, what you'll see on your printout won't be what you ejqiected 

in most applications today you want Return insertion turned OFF. 
Howevei^ ndtW the Super Serial Card nor the od^nal 11c hare a command 
for doing this mth the Sipt Strtal Card Mi I^ 
defaults to no tetum insertion, anyhow. With Bic ori^nalllc, however, which 
defeults the other way, it is a problem. The lie manual mendons a POKE you 
can use to turn off f^etura insertion, but we're not allowing POKEs in this 
article. The only command-based alternative for turning off Return insertion 
on the original lie is to use the Zap command. There are nocommand-based 
alternatives for tuming off Return insertion on the Super Serial Card, not 
even Zap does this so don't turn it on unless you rea% need It 

While most applkations work best voth i^turn inseil^n OFF, tj^Tbis 
^)plesofl:pK}gamaoEi a ptttliic!r"u»rKs{)ekW!thHei^ 
way the ends of lines that are more than 80 characters long are "vamped" to 
thefbllowing line rather than beii^ printed on top'ofthe beginning of the line 
The I Ic and most parallel cards do this automatically. The Super Serial Card 
and the llgs, however, require two commands to implementthis. One is to set 
the line length to somdhll^ 001© than zero and the seccmd is to turn on 
Return insertion. 

To turn on Return insertion with the Super Serial Card, the command is 
"G," as in "control-I C" This syntax works only on lh&Si.qper Serial Card, 
hamt&i The a.5II0M lie andlhe Qg^si^IKHtM^^ conmiand 



for this, as In "control-1 C E." On both versions of the lie you can also turn on 
Return insertion simply by setting the line width to a non-zero value. (The 3.5 
ROM lie's "C E/D" command sets Bie line width to zero when you choose 
disable and sets line width to the initialization default when you choose 
enable. Thus, if the c^^t lliie wdd^ is zeio, as it is in CQmmunicalioQS 
mode, ffic *t; If tst^iffid hm no eiBi^ tlottDWtpj^use one dftheline 
width commands to set a posldve line width insteeyj,?: 

To summarize: with the lie (and most parallel cards)^ Return insertion 
always occurs unless the line width is set to zero (unfortunately, however, the 
original lie has no command for setting the line width to zevo other than Zap), 
mth all other Apple interfaces. Return InsertJiwrBquilcsbotha noai'^^ 
width and enabled Return insertion. 

Line width is controlled by a variety of commands, only one of vthich is 
nearly universal Tlie T' command, as in "cotitrol-l I," sets the line width to 40 
on the Super Serial Card (it also affects echo; more about tliat in a moment]. 
On the lie and the llgs the "1" command has no effect on fine width. Both 
versions of the lie and the llgs support a line width command that consists of 
a decimal number, between 1 and 255 inclusive, followed immediately by a 
Return. The Rehim is eaten by the firmware and the line vwdth is set to Hie 
decimal number. This command has no affect on fidito. The Super Saial 
Card doesn'tsupport this command howevec 

The neailyF universal version of the line tndlh tJoniiaeM Is "nifl' as m 
"conboH nil" vidieie the small "n" is again a dedmEd number between 
llgs) or 40 (SSC) and 255 inclusive. What preverjts this command fbom being 
universal is that it doesn't work in communications mode on the Super 
Serial Card Another feature of the "nl*f" command (which is one of the 
"parallel card commands" that nevQ- reqnbes a Rebim afler it) is that it 
disables Echo. 

There are also a varied of ways to control Echo, The simplest fa the Edw 
enabl^ cMsable cpmmand,asin "ojnlml-AE P," for exatnple.This cpmmgmj 
Esn't avafkbte m m^ m^m of 19k Qb, however, mr \a ft araisiUe fkni 
printer mode oh fllB^^^SWal Card. The "I" command mentioned eariier 
(which is the third and tna! of the paralld commands that never require a 
Return) enables Echo on all interfaces except the Super Serial Card in 
communications mode. In printer mode on the Super Serial Card, it also 
changes the line width. The "nM" command disables Echo on all interfaces 
except (he Super Serial Card In communications mode, it also changes the 

mmm. 

When you arc using a program such as AppleWQiis,you want your interface 
card's Echo disabled and Return insertion off. (Echo disabled so that what 
you print doesn't appear on the AppleWbrks screen; Return insertion off so 
that AppleWorks has complete control over Reh4m placement) The W 
command is the universal "no Echo" command. Unfortunately, there is no 
universal "no Return " command — in fact as we have seen, the Super Serial 
Card and the original lie don't have any command for this at all On some 
third-party parallel Cfflxls, "conttol-1 OM" does the trick. However, the Super 
Serial Card ignoiESthis command completely; the lie and llgs respond by 
disabliiig Edw but leaving the line width unchanged. The closest thing to a 
universal interface card command for AppleWorks and similar programs 
would be "control-I 255ri." This disables Echo and, while it doesn't turn off 
Return insertion totally, it will suffice until we have printers that can fit more 
than 255 characters on one line. 

While AppleWbrks and similar fm^imm:^ei Echo and Retum insertion 
QW, Applesoft ptogrammiers c^'pt^ to haw them both on This is so 
that jou can see whatyou'refyping afteryou enteraPR*! command from toe 
keyboard (ifEcho is disabled what you type appears only on the printer), and 
so that long lines wrap Gonectty, as mentioned earlier. There are no universal 
commands to accomplish this, either. On the Super Serial Card you must 
execute the "contml-1 C" command to get retum insertion to work at alL If 
you next do a "control-l I" to enable Echo, that command also sets the line 
ulti^ 1640. If you try to change tlie line width to something longer with a "nTI" 
QOojUiand,,^ vol 1^ Qptdia —theSuper Serial Card won't 

hai^ Keton itiset^n unless flie ttne v^kttb Is 40. On 

ttie licRetum insafion woiliswiBneverflie linewidth is non-zeto, so an "nTT 
command to set Qie line width you want Mowed by an "I" command to 
enable Echo will get you vAtem you want to go. Finally, on the llgs, you first 
must enable Retum insertion with a "contrcJ-1 C E" command, set the line 
width you want with an - W CDmrnatiHt and enableEclio wUhelSieraii't' car 
an "E E" command. 

In communications mode, whether you want Echo or not depends on 
whetheryouaiGworiKingwith a "M duplex" or "half-duplex" hostcon^oter. 
Und^ i£r %[^cal fiilHtttpl(n arraogemeni ^ host computer edios the 
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characters it receives from you back to you and it is the echoed characters 
Uiatappearon your screen. {You jype "A," ttfloes outyour serial port through 
your modem, down the tdefrttoiie tine, ttiiough the leoeivefs modem and 
serial portto the host computer, «Adt^ edios it back through its serial port 
and modem, over the telq)hone line, (hrough your modem and serial port 
and onto your screen— makes you appreciate the speed of electrons. 
Incidentally, if both computers areset up to echo everything they receive, the 
"A" flies back and forth like a ping-pong tiail and the communications link 
seems to freeze up.) Under fuJl-dupiex you want your local Echo disabled, or 
else ail the characters will appear oh your sere en twice. A half-duplex host, on 
the other hand, does not echo your characters back to you. For this you want 
local Echo enabled, or else you won't be able to see what -pw are l^mg. note 
Itiat in ^piDpiiqalvws mode the Sup^ S«3dpl ^^s^^^Sixgi^pA^ "J^Ej 

command, as does the Ugs. Tbe He ami Aie^jE^ 
mode don't have this aimrnandjag^In^your tjniy insoinvBete ioomtiDl Echo 
with the "I" and "nM" commands. 

Baud, data format, and parity. For most application s there is no reason 
to have to change t>aud, data format or parity by command. You should be 
able to set up your system so that the correct characteristics are chosen by 
de&ult ViSth the Super Serial Card, you choose tlie defaults by setting dip- 
switches, vnth the Ilgs you choose the deEiults with Che control panel. With the 
Ucyou choose the <teWlta with the S^tem Utilities program. If you'd rattier 
nothave ia *sin £^S^^^i91i Offlities program eveiy tiiTie you turn your lie oa 
simply make your jmntei, modem or whatever matdi the He's de&ult 
defaults —9600 liaud, 8 data bits, no parity for port ^ 300 t>aud, 8 data Mts, 
no parity fbr port 2 {for more Infomiation on data format and paii^see UlMle 
DC©'s introductory comments in last mon th's issue, page 3.69), 

!f you must change one or more of Uiese characteristics by cotiimand, at 
least you'll fi nd near perfect consistency in ttie commands available to do 
i)isk Baud is changed with an "nB" command; data fbrmatiiith an "nD" 
command, and parity witti an "iir'command,where 'n "is: 
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le 2408 default on SSC/lIgs, briuBS lie craiy, 

11 3S00 40 has 1 stDp Lit with parity options A-7. 

12 i(B9a 7D has 1-l/Z stop bits ultti parity opClons 8-3, 

13 7288 SS; an8 lie only 

lA 3608 4P-7P nnl auailable on Ilgs 

15 igzce 

As almost always, the Super Serial Card expects a iteturn after these 
commands, the lie and llgs don't 

lIiit(Asba]qiig. Handshaking is a morass I'djustassbon not getlnto. but 
^noe serial devices don't work weO without it I guess well have to. Here^^e 
idea of handshaking— you are printing an AppleWorks spreadsheet on your 
printer and your interfece and printer have been set up to communicate at 
9600 baud. Although your printer can communicate at that speed, it can't 
achially prini anywhere near ttiat fast Most printers have at least a small 
amount of memory for storing a few of the characters waiting to be printed, 
but kiT large amounts of characters the printer has to have some way to tell 
ihe computer to stop and wait Once the printer has caught up, it also needs 
a\^ to teU tbecomputis to ps^E^ed XUsisvdiathandSi^ng is all about 

Soialife^itiss h»/tSieiKMi^ki&lihari^mii that go by nami^ 

such as "data carrier detecf (DCD), "data set ready/data terminal ready" 
(DSR/DTR), and "request to send/clear to send" (RTS/CTS). These protocols 
involve electrical signals on special wires running between the sending and 
receiving devices. With the Super Serial Card and the Apple lie the 
commands for changing hardware protocols invoke a pair c^wire cutters and 
a soldering iron. The Apple llgs allows you to indepaidently turn DCD and 
DSR/DTi^ handshaking on and off using the contrt^panel ds^ults or using 
CCmtrol calls to the Advanced Inteifscei butpnwidesnoconiRiand strings for 
tWs. 

Jn additibh ^ Jwti^i^ pKit^cols, there are software handshaking 
piotocols. These InvdNre tbeteo^t^g device sending command strings to 
the s^dlii9 de\doe Ifiat W It nAm to start and stoi). Die vet^ion of ttds 



fiotocol used by Apple's interfeces is called XOTi/XOFF. It is available on all 
ttie intetbces we'ie discussing Ipte except the orlg^al lie, which dof^'t 
SBj^«atftThe command fir tiMnglftonamd offis "X^/D.^itahirapdefeoHB 
to off. 

Applesoft TflBs. The Super Serial Card and the Ilgs include a command 
that causes ttie Monitor's horizontal position counter to be left equal to the 
colunm counU Normally both the Super Serial Card and Uie fiippie II 80- 
ojiamn Anawaie force this counter to zero. Tto get the Applesoft FKrTT TAB 
command to work correctty u^en se^dji^stuff toyour ptiiiter. It Is necessary 
to PfUiYT CHR$(21 ) to the screenigitm a^i&B^lQ^x^iiM firmware and ttien 
to issue the serial inters Tab ammwuLTi^Wtmi^ bas ttie enable^ 
disable syntax. With the Super Serial Card the oonmiantfletiE 
Ilgs it is "A," so for example, "control-1 A E" would enable Tabs on the llgs. It is 
also a good idea to disable Echo u+ien using the command, otherwise the 
first few lines of your Applesoft program, which lie adjacent to ttie memory 
area used for the text screen, can get poked full of holes as characters are 
displayed beyond the 40 th column of the 40-column screen, 

neither version of the 11c Ijlis a 1^3 command, fbr some more universal 
solutions to this problem, see "iWf TM altanativesr to our Macfc1S87 
issue, page 314, 

Communicatioiis mode. All three interfeices include "dumb terminal'' 
sofhware, Thislets you talk over a modem quite easily lione of your session is 
saved anywhere, however, so yo*J can't use this for "downloading" material 
any faster than you can read it or copy it onto a sheet of paper. For all three 
interfaces, the command for entering the terminal is T," as in "control-A'n' 
To exit the taminal, use "oontodl'A Q." 

M tiuee int»6GiS also s^pus^ "lenuj^^ontn;^" terminal commands, 
tlikmeamfhat ITa ocmti#T«i^ temi a it^ncte den}ti%,y6aF serial 
SmvsK will jump into tenminal mode and stay there until it sees a control-H 
1 can't quite figure out what the practical value of ttiis feature is, but 
somebody somewhere obviously once thought it was important It can be a 
troublesome feahire if you are trying to receK'e binary data ttirougli ttie serial 
firmware and ttie data accidentally' includes a control-X because further data 
(up to the next contitrf-R) will be lost A similar problem occurs if you have 
JEOH/XOFF handshaking enabled and you receive a conhol-S or conbol-Q 
ftt^Xorr and xoli characters). In tl»tsa$is,atttsev^^ 
^t!OKi will be eaten. In some catses, all 6i3^i&ex 6k contn^ and before 
(he nextconhoKl may be lost 

Wth (he Super Serial Card you can avoid both problems hy turning off 
XOn/XOfT protocol (conversely, this means conhol-T works only if XOPi/ 
XfflT is enabled). On the lie, a Zap command will prevent conhol-T and 
control-R from working. The llgs doesn't have a wt^F to pjferent a>irtit*-TaHd 
control-R tomworkiiigtbatl canfind. 

mutcie deivicels comiption of Ibeda^^ acdikntal laps on yourls^KHnL 
nonhalty the serfed firmwate accepts Input feom the remote device and tfie 
keyboard simultaneously. A program can temporarily disable the k^board 
by issuing a ' control-A F D " command. Aiter this command, Iffiyboard pecks 
will be ignored. The keyboard can be re-enabled with "control-A F E," but 
obviously ttiis will have to come fiom your program —you can't type it in and 
expect anyttiing to happen. 

One otti^ f^tpe you va^ find useful in cpnunuriications mode is the 
power f0seQd a BR%:^paL tfa& slipBl cotitt 2S oiffiseconda 
worth of zero bits and is used ty some computer systsans for sIgnoE Onfn 
Super Serial Card, the command for ttiis is "control-A B Return." On the He 
and llgs it's "control-A S." I can tell from the Super Serial Card and lie source 
code Uiattheir versions of BREAK are shortKrthan 233 milliseconds when an 
accelerator is used; Isuspectttilsvasfixied on the Ilgs but 1 canitfipiee out a 
uaytotestit 

Ofteir GflUDnonds. The Stp» S^yi Cioil si^torts s^erat mote 
commands not already m«it!tmed.7lffieeoft}igse E^ del^ after 

carriage returns, linefeeds, and formfeeds. Pftnters wlfiioutmemory bufers 
require these delays or they skip characters that come in while the printer is 
moving the print head or the paper neither the lie nor ttie Ilgs support Uiese 
commands. The Super Serial Card also has a command that allows your 
Apple to be connected to a modem in one slot and an external terminal in 
anotti^ and a CBimnand IW can £ause amversicns betweai upp^' and 
fowei-case. 

Of mom tttteii^ is 3 com»ii»£ i^tte a CEaEBmnd tiat cables 
input and output buffering. IssiK a Wiftiaild art »»%)nbiol-A B E" and 
you suddenly have 2,048-fiyte hiifersfet Irtl ffljattand oulput (assuming 
the merrtoiy inanaser has (hat muc^ mefticiy avaUal^e— if notyoull set 



128-byte buffers). The size of these buffers can be changed using Advanced 
Interface control calls. 

Here's how the buffers work— whenever an incoming character arrives or 
an outgoing character has been transmitted, the serial chip will send an 
interrupt signal to the firmware. The firmware collects incoming characters 
and puts them in the input buffia and takes dmasbas out of Ihe outpiA 
bulfer and transmits theiB. 

USSR other Ilgs serial irnrware I^itines, buteiltig status sfter pott 
initialization can be controlled with the control-panel. Plote, however, that if 
your control-panel default is set to no buffering and you set up buffers by 
command, Itnsebufers will disappeEffifyouieinidal^ ttiep«twithaPR^ 
command or the equivalenL 

Applesoft ptogFams can g^Mconljiig chaiacfeFS fsm thet^tft biiGlBr or 



put outgoing characters into tfte output buffer with normal ITIPBT anil PRITTr 

commands. The advantage of an input buffer is that normally Applesoflcan't 
do iriFUTs fast enough at high baud rates to capture all incoming characters. 
But with a buffer and handshaking, the serial firmvrare eltectively slows down 
the rate of transmission so that Applesoft can handle it error-free. The 
advantage of an output buffer is that you can PRirtT a chunit of text and go 
about your business while the Smtme sm^ ft out at a slow tmud rate- 

Usir^Advanced 111 terte cortM caAl^frfth the ^ 
build on the buffering routines to do fanq/ stuff such as create large printer 
buffers for background printing. The Ilgs can feed characters to your printer 
at whatever speed It requires while you go on about your business. 

If last month's article made you sleepy, this month's might give you 
insomraa. Ihapefl^M tip ttjetOT^t&Mb^* 




Ask 

(ortelO 

Uncle 
DOS 



// you've ever daydreamed of hauing a like 
(Atde DOS, ^you're good, and if sw'm {xmritbed 
totheAppieiLsendaiesume toJimlfeniBiffanagei: 
Apple U Deoek^r Tedrnkat Support MS^2?'Ti^^ 
Computer Inc.; 20525 /fariani Cupertino, CA 
950U. 



Mopping up EMI 



Television interference (TW), radio interference 
(RTI), and broadcast interference (BCf) are three of 
the biggest problems that plague home computer 
owners, as mentioned in last month's letter "Apple 
Haltes family Qnimpy" (page 3.70). As a group, they 
are known as electro magnetic interference {EMI). I 
am aham radio operator and haue had to learn qidte 
a about itAut causes ^ prdbfeiroiand viiit^ 
be done to fix them. Sometimes, fixes are reJflttaejjr 
ea^. Other tbnes they are simply impossible, 

Some reading material that Open-Apple readers 
who have EMI problems might find interesting are the 
Apple ^^FIus/lJe TVoiiiilesflooting & Repair Guide, by 
RobertC. Brenner, pages 189-194 (H.W. Sams, $13.95), 
Kadio frequency Interference (American Kadio Relay 
League, $4), and the October 1987 issue of PC 



ComputeisctesteCNl because they hsjueascOlatoTs 
—components that create electronic signals that 

"rtbrate" on and off very rapidly The Apple He's main 
osdllalDr vibrates at a speed of just over 1 MHz (1 
million vibrations per second). The Apple ll's power 
supply also generates electronic vibrations in the 10 
100 kHz range <10 to 100 thousand vibrations per 
sespjid). If you have a speed-up card, it also has an 

In a |e^ec| wprld, the &eguen4e9 intoned 
wuIdffi^Mnsrasiseft^^wotd causetnle^^eiBae 
with radios atii TV^ Howevec Hie osdilators also 
create harmonics that win extend far beyond the 
fimdame ntal frequency. These harmonics usualtyme 
where EMI and otiier problems occur. 

EMI can be "conducted" (passed through wires— 
usually the AC power tine) or "radiated" (psesed 
iniiiUshai>aGellteiadlodgnals).^oniies!?nplefideas 



that can solve conducted EMI are to mate sax the 
computer and TV are on separate AC circuits and to 
connect traps or line filters between the power outlet 
and the TV or computer or both 

If your problem is radiated EMI, some simple 
soludons may be to locate the computer ferther avbfay 
from the T\i to rptatje or reposWoii your TV antenna,, 
to rebate Hie Tfs hrih'Jead antenna caWe wifli 75 
ohm TVcabIe,-or to subscribe to caMe television , 

Or you can unplug all the cables from your computer 
and see if that helps. Cables can and do act like 
antennas— they radiate the computer's intemal EMI 
to the outside workt, VRlh the computer on and no 
cables connected, see If you still have interference. If 
not, you can reduce radiation from pur cjjbles 
(including thepower cord) with "fenite cores " If your 
computer dealer has a sharp tedinldan, they may 
keep them in stock. A good electronics supply house 
should have them too. Computer Radio, Box 282, 
Pine Brook, MJ 07058 sells a split-ring clioke that is 
very easy to install and is specially designed for 
computer EMI applications. For $17 ppd you get a 
pacl^ of four CQV^ Th^e cotes are spGt so that 
caMesiiffife coaweaow cstfi Be wbt^ in tfiem, Mnd 
the cable two to ftmr flmes around ttK core; 

From this point on fixes gel hiore difiiculL 

My Apple lie is by farnot the worst computer in my 
house. 1 have an MS-DOS ctone that completely 
obliterates all in the house. But thafs another 

J.QalgClarkJr. 
Ham i^dio Magazine 
Qieen]nlle,rL]l 

PMin 

...I can't get-Ihe "AppleKbrks as copy machine" 
patch (October 1987, page 3,71) to work. The jMtch 
didn'tindude loading dtaecUcosfor the SEG.M1 file . . . 

LeeHayward 

...October's "AppleWorlfs as copy machine" letter 
instantly appealed to me. But there must be a few 
jntroduciQiy steps belbte one ^ypes the palcii^i^£u&> 
tions.This poor soul isn't em able to toad SGQM. .. 

RobertXHebD 

'Wsei^M&eBpat^m pt^liBS WWi 
dontl(^ tblofflf seii&i<ti. ImM^fmie imOe 
dm: Sbwe the patch fs only one byte long, Bird just 
p0feesJltetneu;iiatue,255, into memo/y at byte 768, 
tktn "BSAVEs"thatbyte into the correctoftlocatiDns, 
in theprosiam. Mere's m &g)/anation: 

Cad - nisninB fsiatype length adr byts 
BSflVE SEE. Ml, TI00, LI, flTSB. 836074 

tioike that the length of what's being saved is 1 
byto bxiig. The A pargmebBi Ms Ba^E.^i^m to 



took foTthat byte at memory ceR 768. The B pmmeter 
telts Basics^m to stuff that byte into the 36,07401 
byte of 5£Qjf i mWch has a file type of $00 (if you 
don't specify the file type, Baslcsystem will give you 
anLEMlSMATOlenor, since RSM normally eipects 
to work with a Blliaty fHe). 

lJt^erD0S3.3thi5ootrimmlis^intaxuxiuld erase 
m iM SSG.M1 and repfaae ttvMha Hiyte fSie, 
Baslcsystem, however. lesaxs^/QJilJust ds U iS 
except for overlaying the 36,074th byte uiJffi the new 
value, for more on this see 'The binary savior," and 
"It's painful to B misunderstood " in the My 1385 
Open-Apple, page 151 

AR Appfeitorfcs patches should be performed on 
backup copies, of course. In case one of us makes a 
mistake, i/j/ou usefrnpofntorone o/the^^ppieJfcrite 
expamon proems it is usualiff necessafy to mafce 
this patch, and others (ike it published here, to an 
originaf copy of AppleWorks, then reinstall Pinpoint 
or your expansion program. The reason this is 
necessary is that Hnpofnt and the expansion programs 
tend to moue things around insWe the vlppteUfcirlcs 
^es; what the patch expectstodvangeatbyte 36074 
may note be cISeuAere fnsfde tfie flfe. 

Two Nnes too cryptic 

Issue (page 3.42-43) is intiiguii^thit tDO Q^cfor 
me, Could you explain it again? 

Gary Smith 
Oareraont, Calif. 

Caii your local phone company aniti^<^9''S^M 
line" for your house. This line willhe sqiarate from 
youT first and will have a dij^erent phone mimbei 
The phone company will run a new cahfc to your 
house that will end on an outside wall somewhere bt 
a box ended a "network connection." This is where 
the phone company's property ends and yours 
fiegins. 

Someiuhere inside j/our house jou shouid he abte 
to find a '^mXkaiTwhm aaMem^ 
firstphone's nehcoricconnectton joins cahles coming 
from ati the phone jacks in your house. If you can't 
find this junction get professional help. 

Run a neii! cable (available from Kadio Shack, 
hardware stores, phone stores ...) from your second 
linens network connection to the interior junction. At 
the nettuoTk connection, attach the new cable's four 
uAes aooordii^ to the. calom ISsi^d cm Oie nebmik 
oonnectlonbat; 

At yaur jumcBon bcx. disconnect Che ytiiom and 
blacfcuifr«s fromyourfstSt telephone line and leaoe 
fhem unconnected. Connect a multimeter to the 
remaining yeilou.1 and i3laclc wires (hat run (o your 
phones from the junction box. They should have no 
uoitage and in/inite resistance. If they don't, get 



3^ f^pftn^Apple 

flow connect the red wife from your new phone 
WnetothR yeHou) wirw running fo {/our phones. 
Connect (he green iDEr« from j/our secxvid Une to 
yfjur phones^ bitack uiiffis. leatie Oie neie jptone 
tine's ffdEour and biactc lobes uncoimedted. 




Eoeryjajckmyowhousenamlmbothphom lines 
miailable. Existing phones vM sSB be connected to 
gair old number. 7b hook a phone to your neuj 
second Une, you either need a fuio-Iine phone that 
will plug into a modular jack and receiue i)oth Bnes, 
or you uMl need a turn-line modular jack" to sUck 
into an adstinsJsck. it wUl gim you two outlets to 
l^u^ MMinBS or modems into— one /or the old line 
and fm far the new JCne. 

Frigid flaiw 

BUI Basham's trick of wiping out a byte in the 
hejtioard micK^rocessor's RAN to fool the Memoiy 
Manager into doing a "Irigid" reboot is extreme^ 
dangenaus ("KcJtxnt, cold mboot Mgid leboot," Ju^ 



1987, page 3.48). Tiiis byte is currently sitting at the 
bottoin of the 9tacl( used by the kejtoard miao. II 
Apple ever does a rovisic^ lE^ Sie tejtboard mioo 

Mtx &e teybckM is Hghfiy wound liito "fte 
control panel and battety badied up RAM, Basham's 
trick could wieak havoc with future re\fisions and 
goierations of the Hgs. 

The reason the Memoiy Manager uses the keyboard 
microprocessor's IW1 to determine whether the ligs 
has been turned off is that the regular I?AH in the llgs 
has an uncanriyabOilyto retain it» state even alter the 
machine turned off. When piDto^(pes of the 

llgs WBfc poWQied ek firai quick^ tumedlKick en, 
the Memory Manager petformed its powei'-off dock, 
which usuallyverified, and assumed thatthe RAMdIsk 
should be preserved. The system would then boot 
from the RAHdisk, which would crash the s^tem, 
since the RAM was not 100 per cent in tact 

To fix this, I came up with the idea of using the RAM 
in tliete^tKn'd nucropiDcessot which is a sta tic RAM 
Itt^ cieaTS qukhly when the pcnwr is jjimed oiT. Eii^ 
ate the Iffijtioard ItIN test was added after Ibe 
keyboard micro's code was done, it reqtdtBdthe ttte 
of an unused byte in the stack aiea. 

Feter Baum 
rUnthWave 
Cupertino, Calif. 

As an Apple emptoyee, Baum deslgnBd^6"Apple 
DeaSdop Bus." which is used to connect the fc^fboartt 
mouse, and other input deuices to theApple llgs. lie 
now runs an independent des^ and consiMngfirm 
and writes a monSidf fmboare column for CM - 




In response to Dr. Stephen White's questions in the 
October Open-Apf^e about Applesoft memory lim- 
itations, there is a suggestion I might mate. 

If ^ that is really required is additional memory for 
variables and strings, may I suggest the use of The 
Be^Ciam0!^ ItsiKMtA^XlSl&buttliKpcpfpiled 
codetakesi^tess spatx^i^^c^^^W^^ 
And while the compiled code stin bas to % 
"lower 48," variables can be stored in Ihe altema^ 
64K memoiy bank, in extended memoiy in auxiliaiy- 
slot cards like f^amWorks, or In standard«lot memoiy 
cards like RamDactor, This aDons the use of much 
larger arrays of data. 

I have used shing arrays dimensioned to more 
than%Oi;K)stilDS$i#inunci^e[ous 
arr^ <lf sfnier s^fi» tetlns pdmt^a^ Meger 
variables. The program itselfiias on the order of 24K 
in length. This will go a loi^ way to solving a tot of 
pnablems. Incidentally, even disk-to-disk compilation 
is fast (measured in seoHids) and execution times 
are gteattyinctmedtiiy the compiler. 

itobertL Myers 

BASIC for the llgs 

Contraiy to your assertion on page 3,71 of the 
October issue that Apple has no plans to make BASIC 
available on the llgs, the Apple Fiograiiimer's and 
Developer's Association wassellmgatxtavefsicHi of 
y^pplis l^s^Cat AppleTest. 

ACGcmigto a pRxtudL^ ^et i ptckedi^lhe 
language is int^reCed and supports sbtiGimd 
piDgramming (DO/WHILE, DO/uriTIL, labels rata 
thanlbientii^bei^lir QOTO andCKlSUB); nmUHne, 



named procedures and frinctions with parameter 
passing, local labels, and recur^ siqipixt; easy tcr 

fteated as *fii«i raw M ifwtismti 

with IMAGE statements; support ht S^(0er and 
double-precision floating point ariihmefUc using 
Apple's SATIE (Standard Apple liumerics EnviKHiment) 
tools, as well as 16-, 32-, and 64-bit integer variables; 
arrays of up to 32,767 elements per dimension and 
up to four megabytes in slie; complete support for 
the llgs Toolbox; and a licensable runtime version of 
the int^pieter that allocs (^dlbutiiin cif ^plications 
to pee^e «to don't ha»e their cm. aapf Ot i^ llgs 
BASIC sDfttrate. 

Some conversions maybe necessai^for ^plesoft 
programs. Version 10 should be released to the 
public during the first quarter of 1988. 

CliffTUel 
San Jose, Calif, 

HTiat / meant last month was that an enhanced 
uersion of Applesoft for the ligs wasn't in Apple's 
pians, not tfiaf an enhanced uersfon c/KlSCuitasn't 
to be. In retrospect, I should haue made ftet clearer, 
as tots 0/ peqpk assume the tun uwrds mean the. 
same thing, 

Ihe^^eefc beta (Tension of Apple U^Bi&Kts 
auaitable to AfDA members for $50 plus $51d 
tupping (Apple Programmer's and Devdopefs Asso- 
ciation, 290 sm 43rd St, Kenton, KM .96055 206-251- 
654fl; memfierehfp is $20 a year U.S.. $25 Canada/ 
Mejcico, $35 elseujAerej, Asyou mention, the /inished 
product is e»pected sometime next year. A corr^Ued 
oersion of this iangiage Is also underdevelopment 
but tWsufli comefbm IM^SBsfems&iJ&cfcsonBilfe, 
fla. 

At Appiefest, AFDA also announced the auatlabftity 
of the first non-5e£a iiersion of the Apple Pro- 
gnanmer's mriahop ($100 plus $419). This pro- 
vides what the professionals tike to call a "command 
shell " whicti Is fancy words for pmmpt-line-based 
/Se-irtanipulatoconimandssuch as those auaitable 

exec P^, and so ca0, as loeS as a iumi( imre 
Basicsj^em doesn't offer. AFWalso induile^jt jllff- 
screen te:>ct editor for ujriting programa, a 6^6 
macro assembler, and a "linJcer," ujhich can make 
one large eiaecutable file ftomseparate program files 
created by any combination of the assembler or 
other AFW languaQes (file's APIS C, amenSu m 
beiB. vet^on 7 fof47S^^ $lSli aid IS^ AueMt 
$119.95 plus iiso. are the APW^ta^ts^es it 
the moment). 

Beta versions o/AFir included a debugger land 
some desfc accessories for peeking at data used by 
the memory manager and system loader during 
program execution. The debugger, which is still in its 
fteU uersion, is no longer a part of APW but is 
auallatjie separately under the name Apple 
D^uasn- ($15.95 plus $.94). 

M A{y)le/^ Ami also released ttie ^pikfM^ 
sayBlen DbkvSJ ($1Z50 piss $.69), tiieAMm 
Wesley version of the Itefinicat fntroductini fp 
theApple ffgs (^7.50 plus $150;, and a first-peek 
photocopied uersion of the ftogramnier's Intro' 
duction to OieAf^Ug^ ($57.50 plus $5.40). 

Ffedm/dy amiable were the Addison-Vlesley 
erastons of the Aj^e llgs Finnwve R^erence 
{tl8.50 plus $2M and the PmiJOS JBSefmncB 
Hatuial ($2L9S $2.75). Also smfabte in a 
photocopierfMft <Alijl is the ^ppte Ugs Iboffior 
Biefermise{$mmptus ^00). 
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